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NOTICE TO USERS OF SWTPC PAPER AND CASSETTE TAPES 


In order to help reduce the time necessary to load programs through either a paper tape reader or an 
SWTPC AC-30 cassette interface, the longer tapes supplied from SWTPC will be furnished in a binary for- 
mat instead of the conventional ASCII. At the beginning of each tape is a binary loader program that will 
load into the computer using the regular ASCII format. The program then executes itself and loads the 
main program in binary. Using this method, tapes will load in approximately 1/3 normal time. When using 
an SWTPC AC-30, lock the reader in the ON position and type L. For paper tapes readers, such as on an 
ASR-33 Teletype®when the load stops after the binary loader has been loaded into the computer simply 
type G. This will execute the binary loader and the remainder of the tape will load into memory. Several 
“garbage” characters may be printed immediately after the binary loader loads in—this is normal. On cas- 
sette tapes, one side will be in conventional ASCII (side with long leader) and one side will be in binary. 
The tapes are formatted as follows: 


L BINARY LOADER MAIN PROGRAM 
IN ASCII IN BINARY 


As the tape loads, you will see one of the following displays on your terminal: {either is OK) 


*L a i 
*G *2? 
* (register dump) * (register dump) 


Some tapes may have an additional feature which will verify that the tape loaded correctly into 
memory. If, after loading the tape, you find that the program counter is not automatically set to the cor- 
rect value then you probably have a verifying tape. If this is the case simply typing aG will automatically 
check the validity of the program and execute it. If the message LOAD ERROR is displayed then the tape 
did not load correctly into memory. The most common cause of this isa memory problem—there can be 
problems that MEMCON and ROBIT will not find. 


The format for a self-verifying tape is as follows: 


VERIFICATION | BINARY LOADER | BINARY LOADER| gg | g| MAINPROGRAM | MAIN PROGRAM 
ROUTINE PGM. CTR. IN ASCH IN BINARY PGM. CTR. 
ee ee ened eee ci — 


As before, one side of a cassette tape will be in binary and the other side in ASCII. 
If you are unable to load a tape please check the following: 

1.) Be sure the reader is locked on to load a binary cassette tape. 

2.) Try different volume and tone control settings. 

3.) Clean your tape heads with alcohol and a cotton swab. 

4.) Re-check all memory if a LOAD ERROR is displayed. 


Teletype® is a registered trademark of Teletype Corp. 


SWTPC 8K BASIC Ver. 2.3 


SWTPC 8K BASIC is a complete BASIC interpreter for use in both home and personal appli- 
cations. Features of SWTPC 8K BASIC include nine significant digit binary coded decimal addition, 
subtraction, multiplication and division, seven digit trigonometric functions and numerous string 
operations. 

This manual is designed to acquaint the user with the various features of SWTPC BASIC—It is 
not designed to be a complete course on the BASIC language. 


Definitions 


Before actually describing each BASIC function, several terms need to be defined and manual 
notation described. 
A command is a BASIC operation that generally has an immediate effect on the operation of 
BASIC. 
A statement is a word or group of words that directs the execution of a BASIC program. 
A function is a BASIC operation that usually results in a numerical operation or string pro- 
cessing. ; : 
A variable is a letter, or a letter and a number, that is used to represent a numeric or string 
value. Variables may be named by any single alphabetic character (A-Z) or any single alphabetic 
character followed by a number (0-9). Variables of this type represents a numerical value. 
Example: A can be equated to 3.44 
B1 can be equated to -7.2315 + SIN(3) 
A string variable is a single letter followed by a $ that is used to represent literal (alphanumeric 
or text) data. 
Example: A$ can be equated to 1234" but not to 1234. (the quotation 
marks make 1234 a string). 
Note: a string may not be represented by a letter and a number 
such as A3$. 
When BASIC initializes, the string variable length is set equal to a maximum of 32 characters. 
This manual uses the following notation conventions: 


[line N/ denotes a BASIC line number such as 0090 

Nvar/ denotes a variable name such as A3 

/exp/ denotes a mathematical expression such as 3+5-2 

/rel.exp./ denotes a relational expression such as A=5 

/string/ denotes a collection of literal alphanumeric characters enclosed 
by quotation marks such as ““TEST1” 

Xx denotes a variable or expression that has a numerical result 

X$ denotes a string variable 


Restrictions on Program Lines 


The following restrictions are placed on all BASIC program lines: 

1.) Every line must have a line number ranging between 1 and 9999. Do not use line # 0. 

2.) Line numbers are used by BASIC to order program statements sequentially. 

3.) In any program, a line number can be used only once. 

4.) A previously entered line may be changed by entering the same line number along with 
the desired statement(s). Typing a line number followed immediately by a carriage return 
deletes that line and line number. 

5.) Lines need not be entered in numerical order since BASIC will automatically order them 
in ascending order. 

6.) A line may contain no more than 72 characters including blanks. 
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7.) Blanks, unless within a character string and enclosed by quotation marks, are not pro- 
cessed by BASIC and their use is optional. Numbers can contain no imbedded blanks. 
Example: 

110 LET A=B + (3.5*5E2) 
is equivalent to 
110 LETA= B+({3.5*5E2) 

8.) Multiple statement lines are accepted with a colon (:) used as the separator. BASIC will 
process the line from left to right. 
Example: 

10 A=3: B=5 : C=A*B 


Data Format 

The range of numbers that can be represented in this version of BASIC is 1.0E-99 to 9.999999- 
99E99. E99 represents 1099 while E-99 represents 10-99, The E stands for exponent. 

There are nine digits of significance in this version of BASIC. Numbers are internally truncated 
(last digits dropped) to fit this precision. 

Numbers may be displayed and entered in three formats: integer, decimal and exponential. 

Example: 153 34,52 136 E-2 

Transcendental functions (SIN, COS, TAN, ATAN, SQR, LOG and +) are all evaluated bya 

limited infinite series. For these functions accuracy is limited to seven significant digits. 


Mathematical Operators 
The mathematical operators used in BASIC are as follows: 


+ Exponentiation (raises to a power) 
— (unary) Negate (used for denoting negative numbers 
+ Addition and string concatenation 


- Subtraction 
Multiplication 
/ Division 
No two mathematical operators may appear in sequence, and no operator is ever assumed. 
(A++B and (A+2)(B-3) are not valid). Exception: 5+-3 is allowed. 


Examples: 
A=BtC A is evaluated to B raised to the C power 
A=B+-5 A is evaluated to B plus a negative 5 
A=3/2 A is evaluated to 3 divided by 2 


Priority of Operations 


| BASIC recognizes the priority of operation in the following order: 
1. Exponentiation (+) 


2. Negation (-) ( 
3. Multiplication (*) and division (/) 
4. Addition (+) and subtraction (-) 


A BASIC expression is evaluated from left to right in the above priority sequence unless paren- 
thesis are encountered. The operators within the parenthesis are evaluated first utilizing the above 
priority structure. 


Examples: LET A=2 


LET B=3 
LEC C=4 
Bt2+C/A+r2 gives a result of 10 


C+2-C/A gives a result of 14 F ‘ 
GNA AD A* (A+B*2)-22  givesaresultofO~Z% y~! /O | 
At+tAtB &+ » — givesa result of 64 / 
AS O- {A1Z 2 \~ 4 ? 

ML -2- T a See 


String Concatenation 


Although any one string variable may be a maximum of 32 characters (or whatever the length 
is set equal to using the STRING= command), strings may be joined up to a maximum of 128 cha- 
racters for printing. The concatenation symbol is +. 

Example: A$= (32 char. string) 
B$= (32 char. string) 
PRINT A$+B$ (prints a 64 character string) 
also: A$= “HELLO” 
BS= “JOHN” 
C$= A$+BE (C$still limited to 32 char.) 


Arrays 


Sometimes it is convenient for a variable to represent several values at one time. A variable 
such as this type can be considered as an array and each element can be accessed independently. In 
referencing an array variable, the element number in the array must be specified along with the vari- 
able name. For example, say we wanted the variable A to represent 4 values. The following program 
would assign a different value to each element of A. 

10 DIM A(4) Dimension A to hold four elements 
20 A(ij=1 : A(2)=2 : A(3)=3 : A(4)=4 

As seen above, a particular element is referenced by a subscript N, such as A(N), where 1 is the 
first element in the array. 

Two dimensional arrays are also accepted by BASIC. Two dimensional arrays are useful when 
working with data which is easily represented as a matrix. 

Example: 10 DIMA (3,3) 
20) A(1,1)=1 : A(1,2)=2 : A(1,3)=3 
30 A(2,1)=4: A(2,2)=5 : A(2,3)=6 
40 A(3,1)=7 : A(3,2)=8 : A(3,3)=9 


gives the following matrix: 1 2 3 
4 5 6 
7 8 9 


String variables may also be dimensioned as arrays. (A$(5,2)) 


If no DIM statement is used to specifically dimension an array, a dimension of either 10 or 10 
by 10 is assumed. 


Program Preparation and System Operation 


At the time that BASIC is executed, BASIC will automatically determine the range of working 
storage. If you wish to limit the amount of memory BASIC uses, refer to Appendix C of this 
manual. This is normally not necessary unless external machine language subroutines are being used. 

The system is then ready to accept commands or lines of statements. For example the user 
might enter the following program: 

150 REM DEMONSTRATION 

160 PRINT “ENTER A NUMBER”; 

170 INPUTA 

180 LET P= A*A*3.1415926 

185 PRINT 

190 PRINT “THE AREA OF A CIRCLE WITH"; 
200 PRINT “RADIUS”; A; “1S”; P 

210 STOP 

If the user wishes to insert a statement between two others, he need only type a statement 
number that falls between the other two. For example: 

183 REM THIS IS INSERTED BETWEEN 180 and 185. 
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If it is desired to replace a statement, a new statement is typed that has the same number as 
the one to be replaced. For example: 
180 P=(A*A)*3.1415926 replaces the previous LET statement. 
Each line entered is terminated by a Carriage Return and is not processed by BASIC until this 
key is depressed. BASIC then positions the print unit to the correct position on the next line. 
If a mistake is made during type in before typing the Carriage Return, a BACKSPACE may be 
used to delete erroneous characters. The backspace character for BASIC is a hexadecimal ASCII 08 
(Control H). BASIC assumes that the terminal automatically generates a ‘‘cursor left’’ when a 
control H is entered. 
Example: 
30 REM THIS IS A TESZ (CTL.H)T 
The CTL.H moves the cursor back over the Z so that the result is 
TEST 
If it is desired to remove a complete line that was typed in before typing the Carriage Return, 
the CANCEL key (hex ASCII 18, control X) may be depressed. This will delete all information that 
was typed in on the current command or statement line. BASIC will respond with DELETED. 
Example: 
10 FOR 1 to 10 (CTL.X) 
DELETED 


PATCH (CTL. X) 
DELETED 
If the user wishes to execute a program at this point, the RUN command , as described in the 
command section, should be entered. 


Program Abort 


lf, at any time, it is desired to abort a looping or otherwise malfunctioning program, BASIC 
has a proviston for exiting the program and returning to the command (READY) mode. The abort 
(break) character for BASIC is a control C , hex ASCII 03. The actual operation of the control C 
varies somewhat depending on the type of interface used on the control port. 


MP-C Control Interface 

This type of interface requires hitting the control C key very rapidly a number of times for a- 
borting a program. It is sometimes normal for several question marks or extraneous characters to be 
displayed while hitting control C. BASIC should then respond READY. 

MP-S Serial Interface (6800/2 Owners) 

When using this type of interface, entering one control C will immediately halt the execution 
of the current BASIC program and will return BASIC to the command mode. During a printout se- 
quence, such as listing a program, typing one ESC (escape) character will cause the current printout 
to halt. Typing another ESC will cause printout to resume while typing a CONTROL C will force 
BASIC back to the command mode. 

NOTE:When in the middle of a machine code USERroutine, control C will have no effect. If 
necessary, the computer’s RESET button can be depressed. Resetting the computer’s program 
counter to 0103 before re-entering BASIC will keep the current BASIC program intact. 


Commands 


It is possible to communicate in BASIC by typing direct commands at the terminal device. 
Also, certain other statements can be directly executed when they are entered without statement 
numbers. 

Commands have the effect of causing BASIC to take immediate action. A typical BASIC 
language program, by contrast, is first entered statement by statement into the memory and then 
executed only when the RUN command is given. 


-4- T 


When BASIC is ready to receive commands, the word READY is displayed on | the terminal 
device. After each pentry, the system will prompt with a ge 
Commands are typed without statement numbers. After a command_has_ been executed, 
READY will again be displayed “BASIC is ready for more input—either another 


ne saeseet toate 
command, or Program| statements. 


APPEND 


The APPEND command causes a program on tape to be loaded into memory. The APPEND 
command operates the same as the LOAD command except that the current BASIC program is not 
cleared from memory. 


CONT 

A CONT (continue) command can be entered after a program has halted from a STOP com- 
mand or after a program has been aborted with a control C. Between the time that the program has 
stopped and the time that CONT is entered no changes should be made in the program. The pro- 
gram will then continue with the next statement after the STOP command or wherever the program 
was when control C was pressed. 


DIGITS=X 

The DIGITS= command sets the number of digits that will be printed to the right of the deci- 
mal point when displaying numeric variables. This will truncate (not round) any digits greater than 
the number printed, and will force ‘‘0’'s if there aren’t enough significant digits to fill the number of 
positions specified in the ‘‘DIGITS =" command. 

A DIG!ITS=0 command resets BASIC to the floating point mode. 

The DIGITS= command may also be used as a program statement. 


LINE=X 

The LINE= command is used to specify the number of print positions in a line (line length) 
where X is the desired number of print positions. 

Example: LINE=65, LINE=80, LINE=40 
Note: Each line is broken up into 16 character “zones’’. If the print position is with- 

in the last 25 percent of the “‘line’’ length and a “space’’ is printed, a C/R L/F will be output. This 
is so that a number or word will not be split up at the end of a print line. If it is desired to inhibit 
this feature (for precise print control) just set the line length equal to greater than 125% of the de- 
sired total print line length. This can be very important when using the TAB command. 

The LINE= command can also be used as a program statement. 


LIST 
LIST (line #) 
LIST (line #m)-(line #n) 

The LIST command causes the desired lines of the current program to be displayed on the 
control terminal. The lines are listed in increasing numerical order by line number: A LIST com- 
mand causes all lines of the current program to be displayed, a LIST (line #) command lists only 
the line specified and a LIST (line #m)-(line #n) command causes all lines from m to n to be listed. 

The LIST command can also be used to output lines to a terminal or printer on another port 
by entering #N, after LIST (such as LIST #7, 110-130) where N is the desired port number. 
Examples: LIST 
LIST 30 
LIST 43, 30-70 
The LIST command can also be used as a program statement. 


LOAD 

The LOAD command is used for loading BASIC programs previously saved on cassette and 
paper tapes. All input/output regarding the LOAD command will be thru the control or defined 
port. Appropriate reader on/off commands are automatically generated. 

If desired, the input from LOAD can be channeled thru a port other than the control port by 
using the LOAD #¢N command where N is the desired port number. The same rules apply for port 
types and handshaking as described in the PORT=command. 

NOTE: Both the LOAD and SAVE commands assume that the punch/read device is set up 
to decode automatic reader/punch on/off commands. If your particular unit is not automatic (such 
as an AC-30 on port @), the reader or punch should be turned on manually before the carriage re- 
turn is entered after typing the respective SAVE or LOAD command. See Appendix G for more 
information on using port #@ as a SAVE/LOAD channel. 

pn 
NEW) 

“== The NEW command causes the working storage and all variables and pointers to be reset. The 
effect of this command is to erase all traces of the previous program from memory. This command 
also sets LINE equal to 48 and DIGITS equal to @ (floating point mode). 


PATCH ; 
The PATCH command causes computer control to be returned to the computer’s monitor. 


PORT=X 

The PORT=X command defines the computer !/O Port which will serve as the ‘Control Port’. 

“"X"' can be a constant, variable, or expression. 
Example: PORT =3 

Warning—If you define a port without a terminal as the control port, all messages (including 
the ‘‘Ready’’) will be inputed and outputed from that port. . .therefore, you will lose control of 
your program. , 

NOTE: PIA ports require handshaking. If handshaking is not available, then you must use 
the PEEK command to examine the PIA registers. Also, BASIC will always accept a break from port 
1, therefore never leave port 1 without a terminal connected. Appendix F defines the correct hand- 
shaking procedure. Each port # is configured by BASIC for the specified type of interface: 

PORT TYPE OF PORT 
MODIFIED PIA (MP-C interface) 


lg 


SWTPC PR-40) 
The PORT command can also be used as a program statement. 


RUN 

The RUN command causes the current program resident in memory to begin execution at the 
first statement number. RUN always begins at the lowest statement number. RUN resets all pro- 
gram parameters and initializes all variables to zero. 


SAVE 

The SAVE command is used for saving BASIC programs onto cassette or paper tape. All out- 
put from the SAVE command will be thru the contro! or designated port. Appropriate punch on/ 
off commands are automatically generated for use by the tape storage device. 
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If desired, the output from SAVE can be directed to another port by using the SAVE #N 
command where N is the desired port number. The same rules apply for port types and handshaking 
as described in the PORT=command. 


STRING=X 

The STRING= command sets the maximum allowable length of string variables. The STRING= 
command may be used as part of a program and must be used before any strings are referenced ina 
program. X may be any number between 1 and 128. STRING is initially set to 32 characters. The 
NEW command will not reset the string length to 32. 


TRACE ON 
The TRACE ON command will cause BASIC to display the line number of the current state- 
ment being executed for every line. This can be an important debugging tool. 


TRACE OFF 
The TRACE OFF command turns off the trace function. 


STATEMENTS 


A statement, in BASIC, is a word or a group of words that directs the execution of a BASIC 
program. Statements differ from commands in that they generally do not cause the computer to 
immediately take action by themselves. Some statements, in fact, must be used with other state- 
ments for proper operation. 


DATA N1,N2,N3,... 
READ V1, V2, V3,... 
RESTORE 
The DATA, READ and RESTORE statements are used in conjunction with each other as one 
of the methods to assign values to variables. Every time a DATA statement is encountered, the 
values in the argument field are assigned sequentially to the next available position of a data buf- 
fer. All DATA statements, no matter where they occur in a program, cause DATA to be combined 
into one list. ar 
READ statements cause values in the data buffer to be accessed sequentially and assigned to 
the variables named in the READ statement. They start with the first data element from the first 
data statement, then the second element, to the end of the first data statement, then to the first 
element of the second data statement, etc., each time a READ command is encountered. If a 
READ is executed, and the DATA statements are out of data, an error is generated. 
Numeric and string data may be intermixed, however it must be called in the appropriate 
order. 


Note: String data need not be enclosed within quotes (“’) as the comma (,) acts as the deli- 
miter. However, if the string contains a (,), then it must be delimited by quotes ("’). 
Example: 


10 DATA 10,20,30,56.7,"TEST,ONE”’,1.67E30,8, HELLO 
20 READ A,B,C,D,E$,F,G5,F$ 
Note: DATA STATEMENTS may be placed anywhere within the program. 
Example: 110 DATA 1,2,3.5 
120 DATA 4.5,7,70 
130 DATA 80,81 
140 READ B,C,D,E 


is the equivalent of: 


10 LET B=1 
20 LET C=2 
30 LET D=3.5 
40 LET E=4.5 
The RESTORE statement causes the data buffer pointer, which is advanced by the execution 
of READ statements, to be reset to point to the first position in the data buffer. 
Example: 110 DATA 1,2,3.5 
120 DATA 4.5,7,70 
130 DATA 80,81 
f 140 READ B,C 
150 RESTORE 
160 READ D,E 
In this example, the variables would be assigned values equal to: 
100 LET B=1 
101 LET C=2 
102 LET D=1 
103 LET E=2 
There are also versions of READ and RESTORE which are used for the manipulation of disk 
data files. These statements are discussed in the Disk Data Files section. 
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DIM/var/ (exp) or /var/ (exp), /var/(exp) or /var/(exp,exp) 

The DIM statement allocates memory space for an array. In this version of BASIC, one or 
two dimension arrays are allowed and the maximum array size is 255 x 255 elements. All array 
elements are set to zero by the DIM statement. 

If an array is not explicitly defined by a DIM statement, it is assumed to be defined as an ar- 
ray of 10 elements (or 10 x 10 if two elements are used) upon first reference to it in a program. 
Caution: The dimension of an array can be detemined only once in a program, implicitly and 

explicitly. Also only the variables A thru Z (followed by $) may be dimensioned - 

for strings. 

Example: DIM A(10), C(R5+8), D(30,A*3), A7(20), C$(30), Z$(5) 
but not A6$(5) 

The DIM statement can also be used in the direct execution mode. 


END 

The END statement causes the current BASIC program to stop executing. When an END 
statement is seen, BASIC will return to the command mode. In this version of BASIC, END may 
appear more than once and need not appear at all. 


FOR /var/ = /exp 1/ TO /exp 2/ STEP /exp/ 
NEXT /var/ 

The FOR and NEXT statements are used together for setting up program loops. A loop 
causes the execution of one or more statements for a specified number of times. The variable in 
the FOR. ..TO statement is initially set to the value of the first expression (exp1). Subsequently 
the statements following the FOR are executed. When the NEXT statement is encountered, the 
values of the named variable is added to the value specified by the STEP expression in the FOR... 
TO statement, and execution is resumed at the statement following the FOR. . .TO. If the addition 
of the STEP value develops a sum that is greater than the TO expression (exp2) or, if STEP is nega- 
tive, a sum less than the TO expression (exp2), the next instruction executed will be the one 
following the NEXT statement. If no STEP is specified, a value of one is assumed. If the TO value 
is initially less than the initial value, the FOR. . .NEXT loop will still be executed once. 

Example: 110 FOR I=.5 TO 10 
120 INPUT X 
130 PRINT 1,X,X/5.6 
140 NEXT | 

Although expressions are permitted for the initial, final, and STEP values in the FOR state- 
ment, they will be evaluated only the first time the loop is entered. They are not re-evaluated. 

It is not possible to use the same indexed variable in two loops if they are nested. 

When the statement after the NEXT statement is executed, the variable is equal to the value 
that caused the loop to terminate, not the TO value itself. In the above example, | would be equal 
to 9.5 when the loop terminates. 


GOSUB /line #/ 

A subroutine is a sequence of instructions which perform some task that would have utility in 
more than one place in a BASIC program. To use such a sequence in more than one place, BASIC 
provides subroutines and functions. 

A subroutine is a program unit that receives control upon execution of a GOSUB statement. 
Upon completion of the subroutine, control is returned to the statement following the GOSUB by 
execution of a RETURN statement in the subroutine. 

Example: 10 A=3 
20 GOSUB 100 
30 PRINT B 
40 END 
100 LET B= SIN(A) 
110 RETURN 
= = 


GOTO /line #/ 
The GOTO statement directs BASIC to execute the statements on the specified line uncon- 
ditionally. Program flow continues from the line specified by /line/. 
Example: 150 GOTO 270 
This statement may be used in the direct execution mode. 


IF /relational exp/ THEN /statement n/ 
IF /relational exp/ THEN /BASIC statement/ (Direct) 

The IF statement is used to control the sequence of program statements to be executed, 
depending on specific conditions. If the /relational expression/ given in the IF is ‘‘true’’, then con- 
trol is given to the line number declared after the THEN. If the relational expression is ‘‘false’’, 
program execution continues at the line following the IF statement. 

Example: 10 IF 5>2 THEN 100 
It is also possible to provide a BASIC statement after the THEN in the IF statement. If this is 
done and the relational expression is true, the BASIC statement will be executed and the program 
will continue at the statement or line following the IF statement. 
Example: 10 IF 5>2 THEN LET B=7 
When evaluating relational expressions, arithmetic operations take precedence in their usual 
order, and the relational operators are given equal weight and are evaluated last. 


Example: 5+6*5>15*2 evaluates to be true 
The Relational Operators 
= Equal 
<> Not Equal 
< Less Than 
> Greater Than 
<= Less Than or Equal 


>= Greater Than or Equal 


Examples: 110 IF A<B+3 THEN 160 
180 IF A=B+3 THEN PRINT “VALUE A”,A 
190 IF A=B THEN T1=B 
NOTE: If an IF test fails on a multiple statement line, the remainder of the line will not be 
executed. 
Example: 10 IF 5<2 THEN 100:: PRINT 3 
20 END 


Control will go to line 20 and ‘’3” will not be printed 


The relational operators = (equal) and <> (not equal) may also be used on strings. 
Example: 110 IF Y$= “YES” THEN 100 
The < (less than) and > (greater than) comparisons may also be used on strings, but only when 
the number of characters in each of the strings being compared is the same. The > and < operators 
compare strings by evaluating the ASCII value of the characters starting from the first (leftmost) 
character. When a character in one string is found to be not equal to its respective character in the 
other string, the greater than or less than operation is made either true or false depending on the 
ASCII values of these two characters. 
Example: IF “AAABA” > “AAAAB” THEN 100 
The first non-equal character in the comparison is the B in ““AAABA”’. The > operator then 
compares this B to the respective character in the other string (an A). Since the ASCII value of B is 
greater than that of A, the operation evaluates to ‘‘yes, greater than’. 
Example: MAE 3 VBE FALSE 
“BY > "A" TRUE 
“ABCDE”<“ABCDF” TRUE 
“ABC” > “ABCD” ILLEGAL, LENGTHS NOT EQUAL 
“BZ2Z" > “CZ2" FALSE 
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INPUT /var/ 
INPUT /var/, /var/, /var/,. .. 
INPUT #N, var 
INPUT “/PROMPT/" /var/ 
The INPUT statement allows users to enter data from the terminal during program execution. 
Example: INPUT X - Inputs one numeric value 
INPUT X$ - Inputs one string value 
INPUT X,Y,Z,B$ - Multiple inputs may be entered, separated by 
“,"", lf the expected number of values are not en- 
tered, another “’?’’ will be generated. 
INPUT “ENTER VALUE",X - Prints the message in quotes, then a 
“2'", and waits for input. It stores the inputed 
value in X. 

When the program comes to an INPUT statement, a question mark is displayed on the ter- 
minal device. The user then types in the requested data separated by commas and followed by a 
carriage return. If insufficient data is given, the system prompts the user with ‘?’. If no data is en- 
tered, or if a non-numeric character is entered, the system prompts ‘“RE-ENTER”. However, for 
string variables a null return will be considered as valid data. Caution: for input A$,B$,C$—a null 
response would create three null variables. Only constants can be given in response to an INPUT 
statement. 

The INPUT can also be used to issue a prompting message before the question mark appears. 
Example: 10 INPUT “INPUT A$”, A$ 

20 PRINT A$ 

would give the following results 

INPUT AS ? 66 (user types this 66 in) 

66 
INPUT may also be used with the #N, directive for input from ports other than the control 
port. : 


LET /var/=/exp/ 
The LET statement is used to assign a value to a variable. The use of the word LET is option- 
al unless you are in the direct mode. 
Example: 100 LET B=827 
110 LET C=87E2 
120 R=(X*Y)/2*A 
130 C$="THIS IS TEXT” 

The equal sign does not mean equivalence as in ordinary mathematics. It is the replacement 
operator. It says: replace the value of the variable named on the left with the value of the expres- 
sion on the right. The expression on the right can be a simple numerical value or an expression 
composed of numerical values, variables, mathematical operators, and functions. 


ON /exp/ GOTO /line (s)/ 
ON /exp/ GOSUB /line(s)/ 
This statement transfers control to the line or subroutine as defined by the value of /exp/. 
The expression will be evaluated, truncated (chopped off after the decimal point) and control then 
transferred to the nth statement number (where n is the integer value of the expression). 
Example: ON N GOTO 110, 300, 500, 900 
Means: If N <1You will get an error 
If N=1 GOTO 110 
If N=2 GOTO 300 
If N=3 GOTO 500 
If N=4 GOTO 900 
If N>4 You will get an error 
Example: ON (N+7)*2 GOSUB 1000,2000 
(see GOTO and GOSUB for a further description of these statements) 
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PRINT /var/ 
PRINT /string/ 
PRINT /exp/ 

The PRINT statement directs BASIC to print the value of an expression, a literal value, a sim- 
ple variable, or a text string on the user’s terminal device. The various forms may be combined in 
the print list by separating them with commas or semicolons. Commas will give zone spacing of 
print elements, while semicolons will give a single space between elements. If the list is terminated 
with a semicolon, the line feed/carriage return at the end will be suppressed. 

1. PRINT — Skips a line. 

2. PRINT A,B,C — Prints the values of A, B, and C, separated into 16 space zones. Use of a 

“" in place of the “’,”’ would print A, B, and C separated by one space. 
(No space is generated if a string variable.) A C/R, L/F is generated at 
_ the end of the line. 
3. PRINT “LITERAL STRING” — Prints the characters contained within the quotes. 
4. PRINT A,B;'LITERAL”—Prints variable A & B and the word LITERAL. 
PRINT may also be used with the #N directive to specify output to another port. 
Example: 10 PRINT #7, “TEST” 
Prints TEST on the parallel device (printer, etc.) on port #7. 

PRINT may also be used in the direct mode. 


REM . 
The REM, or remark statement, is a non-executable statement which has been provided for 
the purpose of making program listings more readable. By generous use of REM statements, a com- 
plex program may be more easily understood. REM statements are merely reproduced on the pro- 
gram listing, they are not executed. If control is given to a REM statement, it will perform no 
operation. (It does, however take a finite amount of time to process the REM statement.) 
Example: 120 REM THE FOLLOWING SUB. CONVERTS 
121 REM DECIMAL VALUES TO HEX VALUES 


RETURN 
The GOSUB statement causes control to be passed to the given line number. It is assumed 
that the given line number is an entry point of a subroutine. The subroutine returns control to the 
statement following the GOSUB statement with a RETURN statement. 
Example: 100 X=1 
110 GOSUB 200 
120 PRINT X 
125 X=5.1 
130 GOSUB 200 
140 PRINT X 
150 STOP 
200 X=(X+3)*5.32E3 
210 RETURN 
211 END 
Subroutines may be nested; that is one subroutine may use GOSUB to call another subrou- 
tine which in turn can call another. Subroutine nesting is limited to eight levels. 


STOP 
A STOP statement can be used within a program to halt execution at a particular place for 
debugging purposes. A CONT command will then cause the computer to begin execution on the 
line following the STOP statement. 
Example: 10 PRINT 5 
20 STOP 
30 PRINT 6 
gives the following output: 
RUN 
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5 

STOP AT 20 
CONT 

6 


FUNCTIONS 


Functions are similar to BASIC statements except that they usually relate to mathematical 
or string processing operations. 


ABS (X) 
The ABS (X) function returns the ‘‘Absolute Value” of X. 
Example: ABS (3.44)=3.44 
ABS (-3.44)=3.44 
ATAN (X) 


The ATAN (X) function returns the angle in radians, whose tangent is X. 


ASC (string or string var) 

The ASC (string or string variable) function returns the decimal ASCII numeric value of the 
first ASCII character within the string. Literals must be enclosed by quotes while string variables 
are not. 

Example: ASC(“?") gives 63 
ASC(“A”) gives 65 
ASC(“B”) gives 66 
ASC("2"") gives 90 
ASC("5") gives 53 
LET B$="5"" + >ASC(B$) _ gives 53 


CHR$ (X) 
The CHR$ (X) function returns a single character string equivalent to the decimal ASCII 
numeric value of X. This is the inverse of the ASC function. 
Example: CHRS$(63) gives a? 
CHR&(65) givesaA 
CHRS$(66) givesaB 
CHR$(53) gives a5 


COS(X) 
The COS(X) function returns the cosine of the angle X. X must be in radians. 


DEF FN/letter/(/variable/)=/exp/ 

This function allows the user to create his very own functions. The /letter/ is any alphabetic 
character. This names the function (i.e., you could have, say, three functions named FNA, FNB, 
and FNC). The /variable/ is a non-subscripted numeric variable. This is essentially a ‘‘dummy”’ vari- 
able (or place holder). . .This will be apparent shortly. The ‘“‘Expression” is any valid expression. 
Note that the ‘variable’ must be enclosed within parenthesis. 

For example, study the following sample program: 

10 DEF FNA(X)=3.14*X+ 2 
20 DATA 5.6,7,0 

30 READ X 

40 IF X=0 THEN END 

50 PRINT FNA(X) 

60 GOTO 30 


RUN 
sh I3 


78.5 
113.04 
153.86 


READY 
As you can see, the dummy variables were replaced with the variables you actually wished to 
use at the time the function was used. 
Note: You may not define the same function greater than once per program, and a function 
must be defined before it is called. 


EXP(X) 
The EXP(X) function returns the base of natural logarithms raised to the Xth power (this is 
the inverse of LOG(X)) and is the equivalent of 2.718282 raised to the Xth power. 


INT(X) 
The INT(X) function returns the greatest integer less than X. 
Example: INT (4.354)=4 
Now note this one: INT(-4.354)=-5 


LEFTS$(X$,N) 
The LEFTS$(X$,N) function returns a string of characters from the leftmost to the Nth cha- 
racter in X$. Example: X$="ONE,TWO,THREE” 
LET AS=LEFT$(X$,6) 
A$ NOW EQUALS “ONE,TW” 


LEM (X$) 
The LEN(X$) function returns the number of characters contained in string X$. 
Example: LEN(“TESTING’)=7 
LEN(“TEST ONE”)=8 
Note: The space does count. — 
Hint: LEN(STR$(X)) = The number of print positions required to print the number X. 


LOG(X) 
The LOG(X) function returns the natural logarithm of the number X. 


MIDS(X$,X,Y) : 

The MID$(X$,X,Y) function returns a string of characters from X$ beginning with the Xth 
character from the left, and continuing for Y characters from that point. Y is optional. If Y is not 
specified, then the string returned is from the Xth character of the string through the end of the 
string. 

Example: X$=""ONE,TWO,THREE” 
A$=MID$(X$,3, 10) 
AS NOW EQUALS “E,TWO,THRE” 


PEEK(X) 
The PEEK(X) function returns, in decimal, the value contained in decimal, not octal, memory 


location X. 
Example: LET A=PEEK(255) 
A will now contain the decimal value contained in memory location 25510. 


POKE(I,J) 

The POKE(I,J) function takes the decimal, not octal, value of Jand places it in decimal, not 
octal, location |. For example POKE (255, 10) will store a decimal 10 in decimal memory location 
255. 

Warning: This function can cause system program failure if improperly used. 
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POS 
The POS function returns in decimal, not octal, the current position of the print head or 
cursor. The first postion (left margin) is position #1. 


RIGHTS$(X$,N) 
The RIGHT$(X$,N) function returns a string of characters from the Nth position to the left 
of the rightmost character through the rightmost character. 
Example: X$="ONE,TWO,THREE” 
A$=RIGHT$(X$,9) 
AS NOW EQUALS “‘TWO,THREE” 


RND AND RND(X) 
The RND(X) function produces a set of uniformly distributed pseudo-random numbers. If 
X (the seed) is @, then each time RND(X) is accessed, a different number between @ and 1 will be 
returned. If X<>@ thena specific random number will be returned each time (the same number 
each time). RND can be called without an argument, in which case it works as if one had used an 
argument of @. 
Example: 10 LET A=RND 
20 LED B=RND(5) 
If you require random numbers other than between 0 and 1, then: 
PRINT INT ( (B-A+1)*RND(O)+A) 
will yield random numbers ranging between A & B. 


SGN(X) 
The SGN(X) function returns the ‘sign’ (+,-, or 0) of X. The SGN of a negative number will 
yield a -1, the SGN of a positive number will yield 1 and the SGN of 0 gives 0. 
Example: SGN(4.5)=1 
SGN(-4.5)=-1 
SGN(0)=0 
SGN (-0)=0 


SIN(X) 
The SIN(X) function returns the sine of the angle X. X must be in radians. 


SOR(X) 


The SQR(X) function returns the square root of X. X must be greater than or equal to 0 (X 
must be positive). 


STR$(X) 
The STR$(X) function returns the string value of a numeric value. This is the inverse of the 
VAL function. 
Example: A=34567 
LET AS=STR$(A) 
A$ NOW EQUALS “34567” 


TAB(X) 
The TAB(X) function will move the print position to the ‘’Xth” position to the right of the 
left margin. If the print position is already to the right of the position specified in the TAB com- 
mand, no spaces will be left and printing (if any) will commence. The first print position (left mar- 
gin) is position #1. 
The TAB function can be used with the PRINT statement to cause data to be printed in 
exact locations. The argument of TAB may be an expression. 


Example: 
5 X=3 
10 PRINT TAB(2); X; TAB( );X*X; TAB( ); X*X*S 
will print 
3 9 27 


TAN(X) 
The TAN(X) function returns the tangent of the angle X. X must be in radians. (360 degrees= 
2x radians 7 =3.141592654 


USER (X) 

The USER (X) function is a BASIC function that enables a user to call a special machine 
language subroutine. The syntax of the USER function is of the form LET /var/=USER (/var.1/) 
such as LET A = USER(X). The use of the USER function assumes that the programmer is familiar 
with assembler level programming. 

When the USER function is executed in a program, the numeric value of the variable X is 
stored in a special BCD (binary coded decimal) format in a seven byte series somewhere in the 
computer’s memory. BASIC then keeps track of where this series is stored so that the machine 
language routine can access it. After storing this series, BASIC then looks at hex memory locations 
0067 and 0068. The computer is then instructed to execute a ‘Jump to Subroutine’ to the hex 
address stored in hex memory locations 0067 and 0068. To avoid accidental misuse of the USER 
function, 0067 and 0068 will initialize to a location which contains a hex 39, a return from sub- 
routine. Locations 0067 and 0068 can be changed using the POKE function prior to using USER. 

After the computer jumps to the location pointed to by 0067 and 0068 it is up to the ma- 
chine language program to perform its special function or to manipulate the data previously stored 
in the seven byte BCD series. To find out where this series is located, hex memory locations 005D 
and OOSE should be checked by the machine program. 005D and OOSE contain a pointer to the 
location of the seven byte series. They do not contain the actual location of the series. 

For example, say that locations 005D, OOSE contain the address 1DB1 This means that 
locations IDB1 and IDB2 contain the address of the seven byte series. If the series was stored be- 
ginning at 242B, then the locations would be set up as follows: 


005D 1D 
OO5E Bi 
IDB1 24 
IDB2 2B 


242B Start of seven byte series. 
The actual number that was stored in the seven byte series is stored in a special BCD format 
as follows: 


for + numbers for - numbers 
BYTE 1 (sign) (Dg) (sign) (Dg) 
BYTE 2 (D8) (D7) (D8) (D7) 
BYTE 3 (D6) (D5) (D6) (D5) 
BYTE4 (D4) (D3) (D4) (D3) 
BYTE5 (D2) (D1) (D2) (D1) 
BYTE6 (Exponent in hex) (Exponent in hex) 


BYTE7 00 — 16— 00 


Where D’s are digits and D’sare the digits complemented. 

The sign half-byte denotes whether or not the number is positive or negative. A sign of O de- 
notes + while a 9 denotes -. The actual number digits are located in half-bytes D1 - Dg. The ex- 
ponent byte tells BASIC where to put the decimal point. Notice that this number is hexadecimal 
and not BCD. 

For example, the number 1234.5678 would be stored as follows: 


Byte1 01 
Byte2 23 
Byte3 45 
Byte4 67 
Byte5 80 
Byte6 04 
Byte7 00 


The number is stored as .12345678 with an exponent of 4 which moves the decimal point 4 
places to the right giving 1234.5678. The 0 half-byte in byte 1 denotes a positive number. 

Now look at the number -1234.5678. Negative numbers are more complicated and must be 
handled with great care. 


Byte1 98 
Byte2 76 
Byte3 54 
Byte4 32 
Byte5 20 
Byte6 04 
Byte 7 00 


Notice that the first 9 in byte 1 denotes a negative number and that all digits Dy - Dg are 
complemented. The complement of a digit is defined a 9- (the digit) with the complement of 0 still 
being 0. In the above example, the digits that were stored were not 12345678 but rather (9-1) 
(9-2) (9-3) (9-4) (9-5) (9-6) (9-7) and (1+9-8). The last significant digit not including any trailing 
O’s must have 1 added to its complement before storing in the BCD series. In the example -1234. 
5678 (the same as -1234.56780) the last significant digit is 8; therefore, 1 must be added to its 
complement. 

The number -7.20008000 would be stored as: 


Byte1 92 
Byte2 79 
Byte3 99 
Byte4 20 (the last significant digit is 8) 
Byte5 00 
Byte6 01 
Byte 7 00 


The end of the machine language program should contain a hex 39, a RTS. This will transfer 
control back to BASIC. BASIC will then assign the numeric value of the number in the seven 
byte string to the variable A in the example A=USER(X). 


VAL(X$) 


The VAL(X$) function returns the numeric constant equivalent to the value in X$. This is 
the inverse of the STR$ function. 
Example: VAL("'12.3'=12.3 
VAL(5E4’’)=5000 
VAL(“TWO")=GENERATES AN ERROR. ‘“‘TWO” cannot be 
equaled to a numeric constant. 
VAL("-12.3")=-12.3 


-17—- T 


APPENDIX A 


ERROR MESSAGES 


If, during the operation of BASIC, a mistake was made by the programmer, BASIC will out- 
put one of the following error messages: 


ERROR # 


DEFINITION 

Oversize variable (over 255) in TAB, CHR, subscript or ““ON”’ 

Input error 

Illegal character or variable 

No ending “ in print literal 

Dimensioning error 

IHegal arithmetic 

Line number not found 

Divide by zero attempted 

Excessive subroutine nesting (max is 8) 

RETURN W/O prior GOSUB 

Illegal variable 

Unrecognizable statement 

Parenthesis error 

Memory full 

Subscript error 

Excessive FOR loops active (max is 8) 

NEXT “’X”’ W/O FOR Loop defining ‘'X” 

Misnested FOR-NEXT 

READ statement error 

Error in ON statement 

Input Overflow (more than 72 characters on INput line) 

Syntax error in DEF statement 

Syntax error in FN error, or FN called on Function not defined 

Error in STRING Usage, or mixing of numeric and string variables 

String Buffer Overflow, or String Extract (in MID$,LEFT$, or RIGHT$) too 
long 

1/O operation requested to a port that does not have an [/O card installed. 
VAL function error—string starts with a non-numeric value. 

LOG error—an attempt was made to determine the log of a negative number. 
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HEXADECIMAL 


ASCII Hexadecimal to Decimal Conversion Table 


DECIMAL 
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DECIMAL 


043 
044 
045 
046 
047 
048 
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050 
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056 
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058 
059 
060 
061 
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063 
064 
065 
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076 
077 
078 
079 
080 
081 
082 
083 
084 
085 


T 


‘| 


Ka Tt rToronanonon®m 


— -—~N < & S&S < CHARACTER 
o 
Oo 


HEXADECIMAL 


oooooooqoo 
OO © © © © © © DECIMAL 
WON] OOAON D 


094 
095 
096 
097 
098 
099 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 


0000 - QOFF 
0100 - 1F83 


002A - 002B 
QO2E - O62F 
@O5D - @O5E 
0067 - 6068 
O14E - 014F 


0156 
157 


0158 
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APPENDIX C 
Memory Map 


Input buffer and temporary variable storage 
BASIC interpreter 


Useful Locations 


Contains the next available memory location after the BASIC program. 
Contains the start of the BASIC source program. 

Contains the address of the current arithmetic value in use during a USER call. 
Contains the pointer for USER. 

This location tells BASIC where to start allocating memory for programs and 
variable storage. Currently this location contains the lowest possible address 
of 1F83. If, for example, you desire to store a 100 byte machine code program 
you can allocate memory from 1F83 to 2083 by changing @14E to 2683. 
Contains the number of the port which BASIC will initialize to. This location 
currently contains 91, the control port. . 

Contains the hex ASCII value of the line delete character. This location is nor- 
mally a 18 (CTRL. X) but may be changed if desired. 

Contains the hex ASCII value that BASIC interprets as a backspace. This loca- 
tion is currently a @8 (CTRL. H). This location can be changed for terminals 
which do not generate an automatic cursor left with some other backspace 
command. 


! Contains the character echoed to the terminal when a backspace command is 


entered. This character is currently a @@ (a null). If desired this character can 
be changed to something else if your terminal does not generate an automatic 
cursor left upon sending a backspace command, such as the CT-1024 terminal. 
Contains the character which BASIC interprets as a break. Currently a 03 
(CTRL. C). 

Contains the character that BASIC interprets as the “‘halt printing’’ command. 
Currently a 1B (ESC). : 

Contains the bit pattern used to initialize the ACIA on MP-S type interfaces. 
Currently a 15 for 1 stop bit operation. A 11 should be used for 2 stop bit op- 
eration. 


Below is a list of the I/O jumps in BASIC for the various ports. For each port the first is the 
“output character in accumulator A” jump, the second receives input and places it in accumulator 
A and the third is the initialization routine for a particular type port (ACIA or PIA). This I/O can 
be changed at the discretion of the user if desired. 


— 20- T 


xPORT © 
O104 FE 16 42 WIMP TAR UMP FoouT 
O109 FE LE née lite FOIN 
Giomt FE 1B 20 ullMF FOINT 
SPORT 1 
O10F 7E OL SC MF OUITVES 
Giles 7E Oo1 47 AlhMF INVED 
Qiis YE os 4c IMF FNEIITYF 
SPORT 
Gila FE 04 iz Wt CLITACTI 
OL1B 7E 04 O8 AE INACIA 
OLLE 7E Os 7E wlhF ACLIINE 
HEUORT 
ATP GQUTART 
ME INACTA 
lide ACIINZ 
SPORT 4 
Je CUITFEIA 
4F INFIA 
ATF FIAINE 


hi 


OL1ZA FE o4 
OiSZo FE O4 
O1ho FE O23 


fo 64 pb 
~1 7) > 


SPORT 


ra) 


JME OUTFIA 


Gh Be 


“ITD 


is? lta INF IA 
15s & ltaF FPIAINZ 
1s7 SPORT & 

140 48 UME CUTPIA 
tei 3F MF INFIA 
Laz a7 IAF FIAINZ 
1é #FORT 7 

144 O145 o4 4A MF CUITELA 
145 O148 Me INPIA 
164 O146 Me FIAINZ 
147 O14E FILE FOE END 
148 150 INZPOR FCE i 

147) 0151 VEREND COMENT 


170 «=6GiSs DELICHR $12 
117i | =—Gis4 BACIHR BE 
172 GiSssS OG ARRITHR $00 
173 OLSé OF ERECHR SCE 
174 O157 iG STPCHR $16 
175 O1se 15 STOPLT $15 STOP BITS 


i777) Gis7 7E 1E &F OFF AME POOF F 


O150 70 OO 1F GUTVEC TST TYFE 
OLSF 24 GS ENE #45 
O16) TE 04 12 At OUTACI 
0144 7E £1 D1 lta MUTEEE 
O1467 70 00 1F INVER TST TYFE 
O16 24 OF BNE #75 
O1460 7E O04 OF MF INACTIA 
GIF 7E Ei At AMF INEEE 


mm 


ee ee ee 


-—21- T 


aoo7n- 


APPENDIX D 
Notes for Speeding up BASIC 
Subscripted variables take considerable time; whenever possible use non-subscripted 
variables. 


Transcendental functions (SIN, COS, TAN, ATAN, EXP, LOG) are slow because of 
the number of calculations involved, so use them only when necessary. Also, the + 
operator uses both the LOG and the EXP functions, so use the format A*A to square 
a number, 


BASIC searches for functions and subroutines in the source file, so place often called 
routines at the start of the program. 


BASIC searches the symbol table for a referenced variable, and variables are inserted 
into the symbol table as they are referenced; therefore, reference a frequently called 
variable early in the program so that it comes early in the symbol table. 


Numeric constants are converted each time they are encountered, so if you use a con- 
stant often, assign it to a variable and use the variable instead. 


APPENDIX E 
Notes on Memory Usage in BASIC 
REM statements use space, so use them sparingly. 
Each non-subscripted numeric variable takes 8 bytes. 


. Each non-subscripted string variable takes 34 bytes. 


Each numeric array takes 6 bytes plus 6 bytes for each element. 


. Each string array takes 6 bytes plus 32 bytes for each element. 


An implicitly dimensioned variable creates 10 elements (or 10 by 10). If you do not 
intend to use all 10 elements, save memory by explicitly dimensioning the variable. 
Each BASIC line takes 2 bytes for the line number, 2 bytes for the encoded key 
word, 1 byte for the end of line terminator, 1 byte for the line length, plus one byte 
for each character following the key word. Memory can be saved by using as few 
spaces as possible. 

BASIC reserves the uppermost 256 bytes of memory for stack and buffer use. 
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APPENDIX F 
Parallel Interface Handshaking 
The parallel interface drivers are written for a conventional handshaking scheme used 
by many printer manufacturers and is the same as that on a SWTPC PR-40 printer. Hand- 
shaking timing is set up as follows: 


“DATA READY” 
ON MP-L 
INTERFACE 
(CA2) 


VALID DATA ON DATA VALID 
MP-L DATA LINES 
(PAO-PA7) 


“DATA ACCEPTED” 

OUTPUT FROM 

PERIPHERAL DEVICE 

(Input to CA1) 
+ peripheral should generate this 
pulse when it has accepted the previous 
data and is ready for more. 


APPENDIX G 
PIA Strobing 
Use of the Control Interface on Port #@ for Read/Punch—On/Off Decoding 

BASIC software contains subroutines to send out pulses to unused pins of the PIA in- 
tegrated circuit on the MP-C serial control interface that can be used for automatic reader/ 
punch controls. These pulses can be used if you are using a SWTPC AC-30 cassette inter- 
face and a termimal in which access to the control command decoding is denied. 

If you intend to use the read/punch control logic output on the MP-C control inter- 
face board, make the following connections from the indicated pins of IC1 on the MP-C 
control interface board to the specified pins of a twelve pin male connector shell. The con- 
nector pinning shown below is correct for a SWTPC AC-30 cassette interface and will need 
modification for other units. Be sure to make the wires long enough to reach your AC-30 
where the connector will be plugged. If you have access to your terminal’s 16X baud rate 
clock, the terminal’s clock bus should be broken and the 16X clock IN and OUT lines 
brought out to the same connector. 


MP-C IC1 pin 7 (read on) 12 pin male shell female pin 1 
MP-C IC1 pin 4 (punch on) 12 pin male shell female pin 2 
MP-C IC1 pin 6 (read off) 12 pin male shell female pin 3 
MP-C 1C1 pin 5 (punch off) 12 pin male shell female pin 4 
Terminal’s 16X clock OUT 12 pin male shell female pin 5 
Terminal’s 16X clock IN 12 pin male shell female pin 6 
MP-C ground 12 pin male shell female pin 12 


These signals are low going pulses and are about 15 microseconds wide. They are not 
buffered and should drive a maximum of only one standard TTL load. 
PIA strobing will work only on a MP-C type interface on port #@ and only on systems 


containing a SWTBUG® monitor. 


ON ee 
‘ 
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Instruction Set Summary 


Commands Statements 
APPEND DATA 
CONT READ 
DIGITS=& RESTORE 
LINE= & FOR /exp/ to /exp/ 
LIST & NEXT 
LOAD GOSUB 
NEW DIM * 
PATCH END 
PORT= & GOTO * 
RUN IF /rel. exp./ THEN /line/ 
SAVE INPUT * 
STRING=& ON /exp/GOT/line(s)/ 
TRACE ON & ON /exp/ GOSUB/line(s)/ 
TRACE OFF & PRINT * 
REM 
RETURN 
STOP 


* Denotes statements that may be used in the DIRECT mode 
& Denotes commands that may be used as program statement 


MATH OPERATORS 


Functions 
ABS(X) 
CHR$(X) 
COS(X) 

DEF FN(X) 
EXP(X) 
INT(X) 
LEFT$(X$,N) 
LEN(X$) 
MID$(X$,S.Y)} 
PEEK(X) 
POKE (I,J) 
POS 
RIGHT(X$,N) 
RND(X) 
SGN(X) 
SIN(X) 
SOQR(X) 
STR$(X) 
TAB(X) 
TAN(X) 
TAN(X) 
USER(X) 
VAL(X$) 


RELATIONAL OPERATORS 


<> Not Equal (numeric and string) 


+ Exponentiate = Equal (numeric and string) 
— (unary) Negate 

* Multiplication < Less Than 

/ Division > Greater Than 


+ Addition, string concatenation <= Less Than or Equal 
— Subtraction >= Greater Than or Equal 


LINE NUMBERS —May be from 1 thru 9999 


VARIABLES —May be single character alphabetic or single character alphabetic fol- 
lowed by one integer 0 thru 9 or $ 

BACKSPACE —Is a Control H 

LINE CANCEL —Is a Control X (CANCEL) 


PROGRAM ABORT—Typing a Control! C should bring BASIC back to the READY mode 


regardless of what the BASIC program is doing (except USER pro- 


grams). 
LINES 
ted from the other witha: . 
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—Each line may contain multiple statements. Each statement is separa- 
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